home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 44 / Amiga Format CD44 (1999-08-26)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-10].iso / -in_the_mag- / basics / amos / amosp61ext.lha / AMOSP61Ext.doc next >
Text File  |  1997-08-27  |  3KB  |  93 lines
  1. P61 Extension V1.2 by Chris Hodges
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Introduction
  5. ~~~~~~~~~~~~
  6. This is a small extension for AMOS Professional to replay P61A-modules.  It
  7. uses the sources of P610.2 by Jarno Paananen. Extension number is slot 25.
  8.  
  9. Source is included.
  10.  
  11. Commands
  12. ~~~~~~~~
  13. P61 Play bank[,pos]
  14.  
  15. Starts playing the P61a-Module in memory bank number bank. The optional pos
  16. parameter  specifies  the  song  position to play from. The bank must be in
  17. chipmem, if the module does *not* use 4 bit-delta samples. In this case,  a
  18. secondary  buffer  will  be  allocated  automatically  to hold the unpacked
  19. samples. The P61 Play command does not set or clear the Pause-flag,  so  if
  20. you  don't  want  the  module  to start immediately, you can call P61 Pause
  21. before.
  22. ---------------------------------------------------------------------------
  23. P61 Stop
  24.  
  25. Stops the module. Does not set or clear the Pause-flag.
  26. ---------------------------------------------------------------------------
  27. P61 Pause
  28.  
  29. Sets the Pause-flag and therefore temporarily  halts  the  music.  Use  P61
  30. Continue to resume.
  31. ---------------------------------------------------------------------------
  32. P61 Continue
  33.  
  34. Restarts a music previously stopped using P61 Pause.
  35. ---------------------------------------------------------------------------
  36. P61 Cia Speed bpm
  37.  
  38. Changes the speed of the module to bpm beats per minute.
  39. ---------------------------------------------------------------------------
  40. P61 Volume vol
  41.  
  42. Sets the volume of the module immediately.
  43. ---------------------------------------------------------------------------
  44. P61 Fade speed [To vol]
  45.  
  46. Fades out the music or fades to the specified volume vol. speed  holds  the
  47. amount of vertical blanks before the volume is changed one step.
  48. ---------------------------------------------------------------------------
  49. sig=P61 Signal
  50.  
  51. Returns the nibble of any E8x command encountered or -1, if no  signal  has
  52. been found. A sig value of -2 represents the songend.
  53. ---------------------------------------------------------------------------
  54. pos=P61 Pos
  55.  
  56. Returns the current position of the song.
  57. ---------------------------------------------------------------------------
  58.  
  59. Legal Issue
  60. ~~~~~~~~~~~
  61. Although this Extension is  Freeware,  the  author  reserves  the  complete
  62. Copyright on this product. Every change on the source should be reported to
  63. the author. Thanks.
  64.  
  65. Recommendation
  66. ~~~~~~~~~~~~~~
  67. Please have a look at my other great extension called AMCAF! Over  250  new
  68. commands and functions! Available on Aminet/dev/amos/AMCAFExt140xxx.lha.
  69.  
  70. History
  71. ~~~~~~~
  72. V1.2 (27-Aug-97): Detected a bug and fixed it in the P61A Sourcecode. Now
  73.                   you shouldn't get enforcer hits anymore.
  74.                   TO ANYONE WHO'S USING THE ORIGINAL P610 SOURCE:
  75.                   Search for the line:
  76.                   move.l  a2,P61_Sample(a2)
  77.                   and replace it with:
  78.                   move.l  a2,P61_Sample(a1)
  79.                   lea     Channel_Block_SIZE(a1),a1
  80. V1.1 (24-Apr-97): V1.0 was completely broken. Fixed everything to work now.
  81. V1.0 (19-Apr-97): First release.
  82.  
  83. Contact address
  84. ~~~~~~~~~~~~~~~
  85. Any mail, comments or donations welcome:
  86.  
  87. Chris Hodges                    Account: 359 68 63
  88. Kennedystr. 8                   BLZ    : 700 530 70
  89. D-82178 Puchheim                Bank   : Sparkasse Fürstenfeldbruck
  90. Germany
  91. Tel.: +49-89/8005856
  92. Email: platon@cu-muc.de         WWW: http://home.pages.de/~platon/ 
  93.